home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 5: The Fifth Dimension / 17 Bit - The Fifth Dimension (1995)(17 Bit Software)[!].iso / files / 3365.dms / 3365.adf / ARexxGuide2_0A.lha / ARexxGuide / ARxG_20patch.readme < prev    next >
Text File  |  1994-04-05  |  3KB  |  67 lines
  1. Short: Fixes problem scripts in ARexxGuide2_0*
  2. Type: util/rexx
  3. Uploader: robin@halcyon.com
  4. Author: Robin Evans
  5.  
  6.  
  7. This patch includes the fixed scripts to replace those that were
  8. included in the 2_0 releases of ARexxGuide. Copy these scripts
  9. to the directory where you stored the original scripts for 2_0.
  10.  
  11. The 2_0a release includes these fixed scripts along with some
  12. minor changes to the text in several nodes.
  13.  
  14.           ======================================
  15.  
  16. I feel a bit like David Letterman after the Madonna interview: I
  17. want to stare into the camera and say "I'm sorry. I'm sorry."
  18.  
  19. Unlike that interview, though, there was nothing funny about
  20. what preceded this. The scripts in the two 2_0 releases of
  21. ARexxGuide had a number of problems. The most obvious was a
  22. bonehead mistake in ARx_Setup.rexx: In last-minute modifica-
  23. tions, I moved the line that adds rexxarplib.library to a place
  24. _below_ the first call to a function in that library.
  25.  
  26. It's very embarrasing, but... there it is.
  27.  
  28. That's fixed in these scripts along with a few silly looping
  29. mistakes in ARx_Setup.rexx, and some more subtle errors. The
  30. most mysterious had to do with hung processes that were
  31. unpredictable, but reported on several systems. Most of the
  32. problems were associated with the routines that check for the
  33. existence of a library.
  34.  
  35. The CheckLib() user function that is used in several of these
  36. scripts has the unfortunate side-effect of revealing rogue
  37. libraries -- libraries that are included on the ARexx list, but
  38. don't properly set a return code for ARexx when a function call
  39. cannot be resolved by the library.
  40.  
  41. Version 34 of "amigaguide.library" is one such rogue library
  42. when used as an ARexx function library. Even in the original 2_0
  43. scripts, it was used only when absolutely necessary and removed
  44. as quickly as possible from the ARexx library list. The new
  45. scripts are even more careful to remove that library from the
  46. list.
  47.  
  48. Other problematic libraries might be included on some systems,
  49. however, so the new versions of ARx_Setup.rexx and
  50. ARexxGuide.rexx check all libraries and temporarily remove
  51. unfamiliar names. The names are added back before the program
  52. exits, unless it's a name like "rexxsyslib.library" that doesn't
  53. belong on the list.
  54.  
  55. Because of problems that are still mysterious to me, but are
  56. repeatable when the LibVer() function was used from a script
  57. called asynchronously (with "address AREXX"), that function is
  58. no longer used in ARx_GlossaryPort.rexx.
  59.  
  60. Version 37.71 of "rexxreqtools.library" is recommended for these
  61. scripts. It is available in the archive "ReqTools22a_User.lha".
  62. Do not use a version less than 37.50.
  63.  
  64. Special thanks to John A. Conant for fixes to the OS 3.x parts of
  65. ARx_Setup.rexx, and to Steve Plegge and Doug Tittle for pointing
  66. out some of the many problems with the initial version.
  67.